home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 014 / fasthex.arc / FASTHEX.DOC next >
Encoding:
Text File  |  1986-11-09  |  4.9 KB  |  111 lines

  1.  
  2.  
  3.  
  4.  
  5.                          FASTHEX
  6.  
  7.                Requires an IBM-PC or PC-CLONE,
  8.                128 K of RAM, one disk drive,
  9.                an 80 column monitor, and
  10.                MS-DOS 1.0, 1.1, or 2.0
  11.  
  12.  
  13.  
  14. FASTHEX is a utility program used to allow the transmission
  15. of binary files when eight bit communications protocols such
  16. as XMODEM are not available. FASTHEX will generate a hex file
  17. that can be sent over file transfer systems which are limited
  18. to standard ASCII format data. The received file can then be
  19. converted back to an eight bit binary format and loaded and
  20. run in the usual manner. Other programs are available for this
  21. same purpose; this program was written because the author
  22. became frustated with the low speed and disk-intensive nature
  23. of these other programs.
  24.  
  25.  
  26. FASTHEX acheives it's good performance by using a large (48 K)
  27. integer array in RAM to store the input file. The other programs
  28. convert the source file in 32 byte "chunks"; much time is wasted
  29. while the disk drive's read-write head moves back and forth 
  30. from the input file to the output file. To optimize program
  31. speed, FASTHEX splits the conversion process in half; the integer
  32. array is used to hold an intermediate representation of the file
  33. in decimal format. The final conversion is done as the output 
  34. file is written to disk. In this manner, FASTHEX makes optimum
  35. use of both the CPU and the disk drives. Both are able to work
  36. at or near full speed at all times; neither must wait very long
  37. for the other to "catch up". In addition, FASTHEX is much quieter
  38. in it's operation. There is no disk drive grinding from constant
  39. stepper-motor activity as is common with other programs.
  40.  
  41.  
  42. As a result, FASTHEX is from 3 to 5 times faster; the biggest 
  43. performance gain is with larger files. FASTHEX can convert itself
  44. in less than 3 minutes. The other programs require 10 to 11 minutes
  45. to do this. This program will work on files of any size. The array
  46. is reused after each 24,000 bytes have been written to disk. Please
  47. note however that Hex files are TWICE the size of Binary files. If
  48. you run out of disk space the conversion will not be complete.
  49. FASTHEX will not crash if this should happen, but it cannot
  50. perform "split" conversions. The entire output file must fit on
  51. one disk. If you own more than one disk drive, one drive may be
  52. used for the source file and another for the destination file.
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59. FASTHEX has one additional feature: it will supply default filenames
  60. for your output files. When doing a Hex to Binary conversion,
  61. FASTHEX will examine the input file and determine whether it is in
  62. .COM or .EXE format and will add the appropriate extension to the
  63. output filename. You may opt to use the default filename by simply
  64. pressing <ENTER> when FASTHEX prompts for an output filename.
  65. Typing in any other filename will overide this feature and allow you
  66. to use any legal filename you wish. On Binary to Hex conversions
  67. a default filename extension of .HEX is supplied; this too may be
  68. overidden by entering a filename of your choice.
  69.  
  70.  
  71. FASTHEX can be used with any combination of floppies, hard disks,
  72. or electronic disks. The DOS default drive is assumed for input
  73. files but you may use any drive by adding a device name (such as
  74. A:, B:, C:, D:, E:, or F: when FASTHEX prompts for a filename.
  75. Any drive may likewize be used for the output file. Enter the
  76. file spec in the standard DOS format, i.e. C:MYFILE.HEX
  77.  
  78.  
  79. This program will trap most entry errors, and allows a graceful
  80. recovery if the conversion has not yet begun. Entering a "$"
  81. for a filename will cancel the chosen function and return you
  82. to the main menu. Once the conversion is underway, your only
  83. escape is <CONTROL-BREAK>. This will terminate the program and 
  84. return control to DOS. The input file will be preserved unharmed,
  85. but the output file will not be useable and should be deleted.
  86.  
  87.  
  88. FASTHEX was written in Compiled BASIC; the interpreted version
  89. was not distributed because it is agonizingly slow. If you
  90. would like to examine the source code, send a SASE to the 
  91. address below and I'll print a copy for you. Please do not
  92. send blank disks as I do not own the equiptment to make such
  93. mass copying practical. If you have any questions, comments,
  94. or criticisms feel free to write. A SASE will facilitate replies
  95. to your questions. NO CONTRIBUTION IS SOLICITED OR WILL BE 
  96. ACCEPTED. THIS IS A UTILITY PROGRAM, NOT COMMERCIAL SOFTWARE !
  97. This program is intended for the use of everyone; it may be
  98. copied, swapped, transmitted in any form, or given away, 
  99. BUT IS NOT TO BE RESOLD BY ANY PERSON OR ORGINAZITION !!!
  100. The author assumes no responsibility for damages resulting
  101. from it's use. No promise is made for updates or maintainance;
  102. with the widespread adoption of binary communication and
  103. error-checking protocols, I hope FASTHEX will become obsolete !
  104.  
  105.  
  106.                    MATTHEW F. MADDEN
  107.                    P.O. BOX 962
  108.                    HARDWICK, GA. 31034
  109.  
  110.  
  111.